perm filename MEMO.TEX[WEB,ALS]1 blob sn#679119 filedate 1982-09-29 generic text, type T, neo UTF8
\magnify{1300}
\newfont amtt\is\tentt
\newfont amr10\is\tenrm
\newfont cmr9\is\ninerm
\rm

\def\.#1{\hbox{\tt#1}}
\def\TeX{T\hbox{\hskip-.1667em\lower.424ex\hbox{E}\hskip-.125em X}}
\def\PASCAL{{\:\ninerm PASCAL}}
\parskip 3pt plus 2pt minus 1pt
\parindent 0pt

\newinsert\footins
\def\footnote#1#2{#1\insert\footins{\interlinepenalty100
	\smallskip\noindent\strut#1#2} }
\setskip\footins=8.4pt plus 2pt minus 4pt
\setcount\footins=1000
\setdimen\footins=5truein
\splittopskip=10pt
\output{\shipout\vbox{
	\baselineskip 18pt
	\box255
	\ifabsent\footins{}\else{
		\vskip 8pt plus 2pt minus 4pt
		\hrule width 2truein
		\box\footins}
	\hbox to 6.5truein{\hss\:\mainfont\the\count0\hss}}
	\global\advcount0 by 1}


Welcome to the exciting world of \TeX82!

The \TeX\ Project at Stanford is extremely grateful for all the energy that
brave pioneers like you are contributing to this large-scale experiment
in portable software. We have tried to make your task as simple as we
could; but of course the world is full of operating systems and compilers
that seem designed to defeat noble attempts like this, so we have not
been able to anticipate all the problems you must face.

Four reports are enclosed with this shipment of the \TeX82 software (unless
you didn't order them):

\item{1.}The \.{WEB} system of structured documentation
\item{2.}\TeX82 (complete program listing)
\item{3.}\TeX ware (four auxiliary programs)
\item{4.}A test file for \TeX

Read the introductory pages of each of these reports first, in order to
get roughly familiar with their contents. (Please, start at the beginning,
{\it not\/} in the middle!) Then follow the recipe in Appendix@H
of the \.{WEB} manual
to install your \.{WEB} and \TeX\ systems, and follow Appendix@A of the
test manual\footnote*{ That appendix meant to say `\.{TRIP.DVI}' instead
of `\.{TRIP.TFM}' in steps 4 and@6.}
to make sure that your version of \TeX\ is working properly.

If you want further background about the internal structure of \TeX82,
it is possible to rent 12 hours of videotaped lectures from the
\TeX\ User's Group, c/o American Mathematical Society, P.O.@Box 6248,
Providence RI@02940.

The present release of \TeX82 is ``Version 0''; it has been
extensively tested, so we expect that very few changes will ever be
made to it. However, the \.{PLAIN.TEX} format macros are still being
worked on, and we expect to do another year of font development,
so you should expect to replace such ``peripherals'' later when
we have got them into a stable state.  All bug fixes will be reported
in TUG{\:\ninerm BOAT}: the \TeX\ User's Group journal.  Apply to the address
above for subscription information.

Here is a list of the files that appear on your tape:

\halign{\quad\tt#\hfil\hskip 3em&#\hfil\cr
CHAR.SET&	Describes the characters we think we're transmitting\cr
TAPE.DIR&	A complete list of the files on the tape\cr
TANGLE.WEB&	Source file for \.{TANGLE}\cr
TANGLE.PAS&	\PASCAL\ program needed for bootstrapping\cr
TANGLE.TEX&	Helps check your installation of \.{WEAVE}\cr
WEAVE.WEB&	Source file for \.{WEAVE}\cr
WEBHDR.TEX&	Macro package for \.{WEAVE} output\cr
POOLTYPE.WEB&	Source file for \.{POOLtype}\cr
TFTOPL.WEB&	Source file for \.{TFtoPL}\cr
PLTOTF.WEB&	Source file for \.{PLtoTF}\cr
DVITYPE.WEB&	Source file for \.{DVItype}\cr
TEX.WEB&	Source file for \TeX\cr
TRIP.TEX&	A test file for \TeX*\cr
\noalign{\footnote{}{* The \.{TRIP} files on your tape are
slightly newer than those published in the test manual.}}
TRIP.TFM&	Used by \.{TRIP.TEX}\cr
TRIP.PL&	Used as a test of \.{TFtoPL} and \.{PLtoTF}\cr
TRIP.LOG&	Check \TeX's output against this file\cr
TRIPIN.LOG&	Check \.{INITEX}'s output against this file\cr
TRIP.TYP&	Used as a test of \.{DVItype}\cr
PLAIN.TEX&	A basic macro package (first draft)\cr
HYPHEN.TEX&	Hyphenation patterns for English, used by PLAIN.TEX\cr
CMR10.TFM&	\TeX\ font metric file for cmr10\cr
CMR10.1000PXL&	Font cmr10 pixels (200 dot per inch version)\cr
AMR10.TFM&	Same, for font amr10 (an improved\cr
AMR10.1000PXL&	\quad version of cmr10, still being developed)\cr
CMR7.TFM&	\TeX\ font metric file for cmr7\cr
CMR7.1000PXL&	Font cmr10 pixels (true size)\cr
CMR7.3000PXL&	Font cmr7 pixels (magnified 300\%)\cr
	}

And there are lots more font files like those mentioned, as well as some
`change files' for the various programs.  We would like to hear about
your experiences in making change files for your system, and can even
include your contributions on forthcoming distribution tapes.

Please note that the file \.{TEX.WEB} is copyrighted; we permit copying
only if you make absolutely no change whatever to this file!

All of these are text files, with 80-character records; it is
safe to remove blank spaces at the right end of each record.
The \.{TFM} and \.{PXL} files are actually supposed to be binary
byte stream files,
what \PASCAL\ calls ``{\bf packed file of\/}
$0\,.\,.\,255$''; but we have found that the most convenient
way to send such binary information is to encode it as a text
file, containing simply a list of decimal integers between 0 and 255
(in four-character fields, with leading spaces, terminated with 
`\.{\char'40\char'40-1}').
A trivial \PASCAL\ or \.{FORTRAN} program
will convert such files into your local binary format, whatever
it is.
 
So---good luck! Let us know if you have suggestions for other
people who will be installing \TeX\ in the future; then we will be able to
send them some additional hints about how to do it.  In the unlikely event
that you encounter any bugs, please remember that we pay a
bounty for the first report received!

Please address correspondence to Arthur L. Samuel, Computer Science Dept.,
Stanford University, Stanford CA 94305.
\vfill\end